l 
84705714 


hed ver 


EXTERNAL REFERENCE SPECIFICATION 
for 


SES MOTOROLA 68COO UTILITIES 


Submitted: 


7 2e  e ee e  s es - e et 


DISCLAIMERS 


This document is an internal working peper ontve. It is 
subject to chances and does not necessarily reeresent any 
officiel intent on the part of CDC. 
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1 INTRODUCTION 


The Motorola 68600 Utilities are a cotfection cf tools te 
helo the software development orocess on the CYRER 170. 
TRANGBK generates absolute records for use by the mcaBCoo 
Simulator or anything that can read Motorela 'S' records, 
SIM@é8K runs the MC6EG00 Simulator. PINDGBK will take a2 
collection of modules ganerated by the CYBIL-CM compiler or 
the MCé8CCG assembler and create 2 naw module from them, 
REFORMESK reeformats a module in CDC object text to a module 
im H-P releecateabie object text and/or H=-P tfleeeal symbols 
records. GENGS68K generates an H-P finker symhbois File. 
BLOMI6E0K builds an ahsolute memory image medule that can he 
put on en object file or object titrery. PURSYM6SK delets 
dehug symbol tables generated ty the CYBIL and the MCEéBCCE 
assembier from 2143 the modules on 211 the files used as Input. 
TFANDILIP transtates an object file or object tlbrary Intec a 
packed file to be down Ioades for 2 DOI box to load inte 
memory. The MCé8O0CG Utilities run as stand—elone commends vis 
the SES processor. 
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De kead 


1.2 ABPLICABLE_ DOCUMENTS 


The following is a  ftist of documents that elther are 
referenced in this ssoecification or ere recommended to aid ir 
understanding this specification. 


1) SES User's Handbook (AQH1833) 
2) SFS Object Cede Utilities (A4RH2922) 
3) SES MCF#BCCE Absolute Linker (ARH4895) 
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20 MOTOROLA 66CCC UTILITIES COMMANDS 


The Motorola 680600 Utilities use System Control Lancuace 
(SCL) syntax as the parameter interface. In the cescrictions 
that Follows, optional parameters are enclosed ir brackets. 
Al! perameters of type 'neme! can heve @ maximum length of 3] 
cheracters, except for parameters designated «es file names 
{NOS file nemes cannot exceed 7 cheracters in tenath),. 


2e1 JRANOSK =_GENERATE_S_RECORDS 


TRAN6BK generates a file of Meteorota S$ records from the 
outout Files of the MC68COG Aksolute Linker. 


tranfée@k tbdr=<filename>d 
Srec=<filename> 
Lun=<usernare>] 


bdr } bh 3 
Name of the header file from the Absolute Linker, 
The fille name has the form wyxxHDR from the Linker 
where xxxx is the name seed given by the tinker. 
This file contains information about the other files 
needed to create the S$ records, 


me a ee wel 


srec i $s 8 | 
Neme of file to receive the S rerords. 


User number of catalog to search for hdr file and the 
other files needed, The default is the current user. 
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Example 


seseztrans8k segmhdr srecfil 
REVERT, END TRAN6EK 


This example shows TRAN6BK creating srec?il from Files that 
are specified by segmbhdr in the current user's catalog. 
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202 SIMGBK = RUN THE MOTOROLA 68000 SIPULATOR 


SIMG#RBK runs the MC48600 simufator and acauires the 


record file thet hes the absculte memory image. Commands for 


ee EP a ee ee 


st 


am ae 


the simuletor can be aeantered at the terminel or entered 
through #8 command file. The output is sither written et the 


terminal or to a specified file, 


NOTE: Documentation for the simultster and its ccommands 


ere 


in the M6éB8COG Simuletor Referance Menuals MEBKOSIM(D2) from 


Motorola. 


sim6ek sreee<filenesmea> 
[efe<filename>] 
foutput=<filename>] 
Cun=Cuserneme>d] 


srec } s 23 


Name of file that contains 'S! records, the absslute 


memory Imace to be toaded by the simulator. 


Name of file that centains commands to be executed 


Immediately upon ectivation of the simulator. 


The 


commend file consists of one or more valid simulator 
commands. If you do not specify this parameters 
SIM@8K takes commands from the input file assigned ta 


your terminal. 


output ero : 


Neme of file to receive the outreut from 
simulator. If not specified, SIMé8K writes 
GHUTPUT. 


Wser number of cataicg te search for the srec and 


the 


te 


cf 


files. If not specifieds the default is the current 


uSéfe 
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Examples 


sesesim6S8k memory 
[Reeeke MABK BATCH SIMULATION 82/07/3296 16244253, BHEEK 


This example shows SIMS&K used to simulete the orogrem on 
File memory. Anv command may he entered after the ? 


sesesim68k cylClsr cf=command o=list 
REVERT, END SIM6BK 


Tris exemple shows SIM68K used with a commend File end en 
cuteut File. The simulator is agolng toa tead cvyvOCclsr Into 
memory and then execute the commands on the file command, 
Nutput from the simulator wilt be on the file list. 


Cd 
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2.3 BINDOSK = BIND MCEBOCO MODULES 


The purpose of this command is te create a singie bound toad 
module from the specified componant ohject or icad modules. 
The code sections of the ofd modules are combined into a 
Single code sections date sections with identicel attributes 
are combined Into a single section and the binding sections 
are combined and reorganized for minimum redundancy. entry 
point definitions which are raferenced from one or more 
component modules are datetec unless they Fave heer exolicitiy 
retained on this command or they have been previously 
reteinede 


hind&Seak filezlist of <filels,username I> 

name=<medule name> 

[module=tlist or ranga of <mocdule named? 

Cretain=list of <externally declared crocecure 
neme>] . 

Tomit=etist of <externaliy dectered procedura 
name>] 

(starting _proceduree<externaily declered procedure 
name>) 

upon=<fileflsusername I> 

Chese=<fileLs» username )>] 

Clock «fileld] 

Toutout=<file>d] 


file $ f & Jibrary i vib: | 

This paremeter may be coded as ep multivalued tist 
of sublists. Eech element of the velve list is 4 
single names refering te the nare of a.file 
etready assianed to the jor or in the current 
userts catalog; or the element is 2 sublists the 
fast subelement in the subltist is a user name tn 
whose catalion the files (er Jibhreries) refered to 
by the other sub-elements mray tbe found. An 
exemole at the end should help clear this up. 


name } n 3 


This parameter specifies the module name to be 
associated with the created module. 
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module ¢{ modules } m 3 
This psrameter specifies the modules or module 
subrances from files or tibrerties thet are to he 
components of the created modules If net 
specifieds all the modules on the specified files 
and libraries will he used as components, 


retsin fo rt 
This parameter specifies the externally ceclared 
names referenced by @ component of the created 
module that are to he retained in the crested 
module. Procedures that have been retained 
previously naed not be respecified in this 
oarameter.s 


omit { o 3 
This parameter specifies the externally decisred 
names in the camronent modules whose definitions 
are to be ramoved from the output module. 


starting _erocedure { spo 3 
This parameter seecifies the externeily deciarad 
name of the procedure at which execution is te 
begin. Qmission csuses last transfer symbol 
encountered to be used. The startina sroecedure Is 
always retained In the new mocule. 


upon $ up 3 
This oparemeter specifies the Pile te contain thea 
created medufe and the user nare in wkese netaloc 
the file is to be placed. 


base $ b ? basellib $ bl 3 

This parameter specifies a file of object cnode 
modules that the uvon file will be eddec. SES 
procedure GOF will be called if the keys b or hase 
or just a file rame is speciried. GCL wilt be 
called if the keys hasellb or hil are specified. 
GQF and GOL use the uvon file as inrut and the 
hese is rawritten with the created wredule #5 the 
fast mdodule.e 
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lock 3} nolock 3 
these parameters determine whether the Jibrary 
upcete process Js Intertocked #earkinst simultanecus 
updates. Coding 3 filename for the lock osrameter 
determines the name of the interlock file. 
interlocking Is the default action when the upon 
file being unodeted In enother userts cataloa. 


eutput |; out 3 
This peremeter specifies the File neme to which an 
object mas of the newly created module is tea he 
written. 


Exemple 
If you type in the following: 


ftntib)) ia tancticne eoeetar te ups hound 


The files mylib and struct are either sireedy loreal or 
putted from your cetalog. The files sines cosines, anc ten 
2re ine the ftniihb cateloc or locet. The name of the new 
module will be trig functions and the new nodule will be on 
the file bound. 
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2e4 REFORMOSK =_REREQRMAT MODULE TO D=P_ORJECT TEXT FORMAT 


REFORMESBK takes a relocatable moduje in the Cnc 


relocatabie object code (known in the HP world 
"reloc”™ type file)» and/or 2) a File cantaining the 


syrboits for each wedule {known to the H=<P as an "“asmh 
type file). One or bothe of these files can be generated» 
as needs dictate. The re-formatted module({s) cen then he 


cowxrnioaded For use on an H-P 64000 workstation. This 
procedure will work on @n input file with more then one 
module. Each module aets 2 separate record an pach of the 


outrout files, 


reform6é&k input=<filename> 
Coutepute<filenamed] 
Csymbots=<fllename>] 
fun=<Cusername> ] 
userid=<CH—-P userid> 


Input 7 FE 3 


object 
text format and converts it to the H=-P fermet. One CHC 
file with relecatable object text is reformatted into 
files which confors to the H-P formet: 1) 8 file containina 


-Sye" 


a ike aa ie 


twe 


as 8a 
Iocal 


Name of File containing the mocule cr modules te 


be re-formatted, 


cutput 2 o 3 


Name of file to freceive re-formatted module er 
modulese If you dontt code this parameters 
value of the oprotile variabie thoretoc! will be 


used (if it exists in your “orcfile™ file). 


symbols { sym 3 


Name of file to receive reformetted locas! sy¥mholts 
for a modul® or modules. If you don't code this 
parameter, the vatue of the oeprofile variabte 
Tholocsym' will be used (if it exists in your 


“"orofile™ File). 


User number of catalog to search for inout 
The default is the currant user. 


userid } uid 3 


A string cf up to © characters that Is the user id 


from an H=<P develooment stetion. 


ry 
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Examole ' 

§ 

sesereform68k cyrel un=cyl70 o=hpre! sym=heoisym es } 
uidzshofile : 

REVERT. END REFORMS8K CYREL=—DHPREL »sHPLSY® H 

The file cyrel is @ file of COC object text in the | 
catalog cvl7¢. The object text in H-? format will be on @ 3 
File newed thorel. The flocs! symbols will be on ai File } 
named hpisym. The user Id hefile is pert of the file } 
Forel. ; 
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200 MOTOROLA 68000 UTILITIES COMMANDS 
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2e5 GENGSOBK ~—_ GENERATE AN Heeb LINKER _ SYMBOLS_EILE : 
4a 

H 

GCENGSGREK eceepts an input the "dha" file cutput from ! 
LINK6SK (the debug keyword must he specified on the call te 3} 
LINK&8K or no “dha "file will he generated). The file js $ 


reformatted Into an HeP Linker Symrbots File falso referred 
to in the H=-P manueis as 2@ “link sym" tyoe File, or "File 
Type 13"). The H-? formatted file cen then be downloaded 


for use oan an HP 64000 workstaticn. 


cenes6ek Input=<filename> 
Loutout=<filename>d] 
fuserid=<H=P userid>] 
fun=<usernemed] 


input } i 3 


{required) name of the linker symbols file outout 


from LINKASSK. The file name 
'xxxxDBGt,y where xxx Is the name 
LINK6EK. 


eutput $ « 3 
{optionsal) name of a file to 
formatted Linker Syvmhois Files If 


has the form 
seed used by 


receive the H-P 
not specified, 


GENGS6EK writes to @ lorel File reamed PHPGSYM!, 


userid = uid 3 


{optioneal) 1-6 character H=P user ID. This Is the 
same ID entered on the HPE4000 In resoonse te thea 


userid prompt. If defeaulteads then 
userid will be used when the file i 
H—P workstation. 


un 3 


the current HP 
s used on the 


{oretionel) user number cf catrion to seerch for 


the Ineut file. If not specifieds 
the current usere 


the default is 
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Exemote ' 

2 

sesegengss68k i=funedbg uld=heid ; 
REVERT. END GENGS6&é8K JUNDBE => HPGSY™M ; 

E 

; 

In this examples the File named jJunedbo Is a file of {¢ 
linker (i.e gichal) symbols: the HP formatted linker ! 
symtats will be on a File named hpesym end the user id } 
theid! is recorded in that file. } 
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2.6 BLOMIESK - BUILD MEMORY IMAGE 


PLOMIGBK cenerates an absolute medule from the cutput 
files of the MC468000 Absolute Linker. The file specified 
by the hdr parameter Is acquired by the procedure if it is 
not local. 


ee ee ee 


bildmis8k name=<modula name> 
hdr=<filename> 
LToutoput=<filename>] 
Cun=<username>d] 


Oa CE whe OE we ee a 


input } | 3 
This paeremeter soecifies the module name to he 
assotciatedc with the created shselute medute,. 


oe te oe a 


ee 


me 


hdr ft h 3 
Name of the header file from the Absolute Linker. 
The file name bas the form xxxxHDR from the Linker 
where xxx is the name seed given by the IJinker. 
This file caonteins information ehout the other 
files needed te crenata the absciute module, 


cuteput } 0 3 
Name of file to receive the new ahsolute moctule. 
I? you don't code this oaremeters the default file 
name is MIBMOD. 


Cee? a ee ee ee ee? ee ee es 


ae 


Cload 


un 3 


es ates 


User number of catalog to search For fdr file and 
the other files needed. The default is the 
current usere 


“@ aa 
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Example 


sesebidmi6@k abs module segmbhdr newmod 
REVERT, END BLDOMI68K 


This exampie shows S8LDMIGEK creatine an absotute mecule 
nemed abs module from files that are specified hy seamhedr 
in the current user's catalog. The mocule will ta or the 
File newmod. 


eb wl OM ek ee ey te ee wi 
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PURSYM68K removes debug symbol tahless cenerated. by 
CYBIL/CM or tha MC680CO assemblers from modules on chject 
Files or object {fibraries. The Input files are acquired by 
the orecedure and the output files ere rewritten 5 
permanent files. The same number cf files must be 
specified for both the input and output perameters,. 


rursym68k Input=<list of fi lenames> 
outputs<list of filaneme> 
Cun=<username>d ) 


eS ee ee ee 


input | i 3 
Name of file or tJist of files conteining cebus 
symbol tables. These files are acauired If they 
ere not local. These files can he object files or 
ehbject libraries. . 


oyuteut { o 3 
Name of file or List of files thet do not contain 
debug symbol tables when this erocedcure is 
finished. All these files are rewritten inte the 
catalog of the user number specified. If the 


wh ea a ee a ee a ml 


input file is an object files the output file will! } 

he en object file and the same hotds true for 3 
object libraries. H 

; 

un 3 : 
User number of cataltoo to search For input fifes 3 

end where to rewrite the output files. The } 
default is the current user. : 
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Frample 


sesepursymbEkK (exec monitor) (cexe mntr) 
REVERT. END PURSYM6RBK 


This example shows PURSYM6BEK removing cehua syrbl tebles 
from modutes ont the file exec and putting the module 
without debug symbol tables on the file cexe, The sare iis 
dene with monitor and mntr. 


ee a a a ee mae 
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TRANDILIB packs object modules en ebjeact files or object 
libraries into byte oriented data mappings so the new file 
or fibrery cen te downleoeded to the DI kox. The object 
modules will appeer to heave been genereatec by CYBIL on the 
C18C. The number of ineut files specified must he the sare 
as the number of output files spacified,. 


trandilib input=<list of filenames> 
outeut=<list of flleneme> 
Cun=<username>] 
CfileStib] 


Input ¢{ | 3 
Name cof file or iist of files to hea trarnsleted. 


Sede ghee EP Ce ee ee ee ee ee ee i 


These files are acquired if they ar net focal, : 

a 

3 

output } 0 3 : 
Neme of File or Fist of files that have heen } 
tranststed when this oroceadure is finished. Alt} 

these files are rewritten Into the catelog of the } 

user number specified. : 

4 

un 3 : 
User number of cataleg te search For input files 3 

enc where to rewrite the output files. The 
default is the current user. | 

F 

g 

file $f fo dib tio: : 
This keyword specifies the format cf the outeut | 
files. If vou code 'lib's the 9 module directory } 

and an entry oecint directory ere included in the 3 
cutput files. If you don't code either keywords 3} 

then the default is "file. : 
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Example 


sesetrandiftib (objfill ob F}ib1) Cobifile ob jfi'3) 
REVERT. END TRANDILIB 


This example shows TRANDILIB packing att the object 
modules on the object file», ob jJfill and the ohject tibrerys 
objlibls into packed object files obifil2 and ebifils. ix 
yveu had srecifled Ib or I Instead of Filles objfil2 and 
objifil3 would have been oacked object libraries 
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The following messages are output at the termineticn of 


commands. 


20001 


20002 


20004 


200c6 


20007 


2ccce 


200CF 


All errors cause command to eberte 


HEADER FILE file name IS BAD 
SEVERITY: Error 
MEANINGS filecneame coes not have the header 
file Formet 


SEGMENT FILE file neme NOT FOUND 
SEVERITY: Error 


ACQUIRE ERROR Fils name 
SEVERITY? Errer 
MEANING? Internal error trying to seaquire 
File name 


USER ID tong luser_id IS TOG LENG, NOW 
short luser_id 
SEVEFITY: Informaticnei 
MEANING? Setf axplenstory 


SYMBOL forgusymbol HAS BEFN SHORTENED TO 
short usymbol 
SEVERITY: Informational 
MEANING: Seitf explanatory 


UNKNOWN DBIJECT TEXT IN file nama 
SEVERITY: Error 
MEANING? Self explanatcry 


UNEXPECTED EQF Crk EQR FOUND 
SEVERITY: Error 
MEANING? Self explanatory 


TOO MANY EXTERNAL REFERENCES 
SEVERITY: Error 
MEANING? Self exolanatory 


MODULE module name IS NOT A MCE8COC MODULE 
SEVERITY: Error 
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MEANING? Self explenatory 


2C016 DUPLICATE ENTRY POINT NAME 
SEVERITY: Error 
MEANING: Entry point name specified more 


than ance 
9 
g 
20C11 MODULE module-name IS ALREADY ABSOLUTE AND : 
CANNOT BE REFORMATTED H 
SEVERITY: Error ' 
MEANINGS REFORMGEK FIs only for reloeratable 3 
modules. : 
J 
2012 ORG ADDRESS FOR section name IS INVALID : 
SEVERITY: Error : 
MEANING: New module is made up of tco many 3} 
modules H 
2 
20201 MULTIPLE IDENTIFICATION RECORDS FOUND ON ; 
MODULE modulalname H 
SEVERITY? Error ; 
MEANING: ‘Setf explanatory H 
3 
3 
20202 SECTION OF NEW MODULE IS TOO LONG ; 
SEVERITY: Error H 
MEANING: New module is made up of toc many 3} 
nodulas : 


20204 UNKNOWN SECTION CRDINAL FOUND ON MODULE 
module _name 
SEVERITY: Error 
MEANINGS Recompolite module 


20205 MISSING SECTION DEFINITION ON MODULE redule name 
SEVERITY: Error 
MEANING3 PRecompile module 


20206 REFERENCING OUTSIDE SECTION ON MODULE module_name— 
SEVERITY: Error 
MEANINGS Recompile module 


9 

202C7 TOO MANY LIBRARIES ENCOUNTERED : 
SEVERITY: Frror H 

MEANING? Self explanatory : 

3 

q 

20211 STARTING PROCEDURE start loroc uname NOT IN ' 


Code SECTION 
SEVERITY: Error 
MEANING? Seif axplanatory 
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20217 ATTEMPTING TO BIND module_names AN ABSCLUTE 
MODULE 
SEVERITY: Error 
MEANINGS module uname cannot be hound. 


wah awe 


20218 COMMON BLOCK common ubiock uname HAS 2 DIFFERENT 
LENGTHS, SECOND FOUND IN MODULE module name 
SEVERITY! Error 
MEANINGS Self exoianatary 


et ea te ee ee a ee oe 


20219 ERROR ENCOUNTERED IN SYMBOL TABLE IN MODULE 
module name | 
SEVERITY: Error 
MEANING? Setf explanatorys recompile module, 


20220 ERROR ENCOUNTERED IN LINE TARLE IN MODULE 
module name 
SEVERITY: Error 
MEANING? Segdf expleanetorys recompile module. 


20301 NUMBER OF INPUT FILES DOES NOT EQUAL NUMBER 
DF DNUTPUT FILES 
SEVERITY? Error 
MEANING? Self explenstory 


20302 MISSING IPENTIFICATION RECORD ON FILE file _name 
SEVERITY: Error 
MEANING? Self exolenstory 


Se ee ee ee ee ee ee ee ee ee ey 


20303 FOUND A TEXT RECORD THAT IS NOT SUPPORTED FOR 
Mc6eCGO ON FILE filename 
SEVERITY? Error 
MEANINGS Seif explanetory 


=m 
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